home *** CD-ROM | disk | FTP | other *** search
/ Mac-Source 1994 July / Mac-Source_July_1994.iso / C and C++ / Graphics⁄Sound / MacGS 2.5.2ß3 Dev ƒ / (Docs) / man.doc < prev    next >
Text File  |  1992-09-19  |  25KB  |  810 lines

  1. .\"- -*- nroff -*- - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  2. .\"
  3. .\"This file describes version 2.5.2 of Ghostscript.
  4. .\"
  5. .\"- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  6. .de TQ
  7. .br
  8. .ns
  9. .TP \\$1
  10. ..
  11. .TH GS 1 "August 16, 1992" "" "CAEN - The University of Michigan"
  12. .SH NAME
  13. gs \- PostScript previewer
  14. .SH SYNOPSIS
  15. .B gs
  16. [
  17. .I
  18. switches
  19. ]
  20. [
  21. .I file1.ps file2.ps ...
  22. ]
  23. .br
  24. .SH DESCRIPTION
  25. Ghostscript is an interpreter for Adobe Systems' PostScript (tm) language.
  26. .I Gs
  27. reads each given
  28. .I file
  29. in sequence and displays or prints it as a Ghostscript file.  It then
  30. interprets commands from the primary input stream (normally the keyboard)
  31. until an end of file character (^D or CTRL\-D) is typed.
  32. Typing `quit' at the Ghostscript prompt also terminates Ghostscript execution.
  33. Typing the interrupt character, e.g.,
  34. .B control-C,
  35. also terminates Ghostscript execution.
  36.  
  37. You can get a help message by invoking Ghostscript with
  38. .nf
  39.     gs \-h
  40. .fi
  41. or
  42. .nf
  43.     gs \-?
  44. .fi
  45.  
  46. .SS "Choosing the output device"
  47.  
  48. Ghostscript may be built with multiple output devices.  Ghostscript
  49. normally opens the first one and directs output to it.  To use device xyz
  50. as the initial output device, include the switch
  51.  
  52.      \-sDEVICE=xyz
  53.  
  54. in the command line.  Note that this switch must precede the first .ps
  55. file, and only its first invocation has any effect.  For example, for
  56. printer output in a normal configuration that includes an Epson printer
  57. driver, you might use the shell command
  58.  
  59.     gs \-sDEVICE=epson myfile.ps
  60.  
  61. instead of just
  62.  
  63.     gs myfile.ps
  64.  
  65. Alternatively, you can type
  66.  
  67.     (epson) selectdevice
  68.  
  69.     (myfile.ps) run
  70.  
  71. All output then goes to the printer instead of the display until further
  72. notice.  You can switch devices at any time by using the selectdevice
  73. procedure, e.g.,
  74.  
  75.     (vga) selectdevice
  76.  
  77. or
  78.  
  79.     (epson) selectdevice
  80.  
  81. As yet a third alternative, you can define an environment variable
  82. GS_DEVICE as the desired default device name.  The order of precedence for
  83. these alternatives, highest to lowest, is:
  84. .nf
  85.                selectdevice
  86.                (command line)
  87.                GS_DEVICE
  88.                (first device in build list)
  89. .fi
  90.  
  91. To select the density on a printer, use
  92.  
  93.     gs \-sDEVICE=<device> \-r<xres>x<yres>
  94.  
  95. For example, on a 9-pin Epson-compatible printer, you can get the
  96. lowest-density (fastest) mode with
  97.  
  98.     gs \-sDEVICE=epson \-r60x72
  99.  
  100. and the highest-density mode with
  101.  
  102.     gs \-sDEVICE=epson \-r240x72.
  103.  
  104. On a 24-pin printer, the lowest density is
  105.  
  106.     gs \-sDEVICE=epson \-r60x60
  107.  
  108. and the highest-density 24-pin mode is
  109.  
  110.     gs \-sDEVICE=epson \-r360x180
  111.  
  112. If you select a printer as the output device, Ghostscript also allows you
  113. to control where the device sends its output.  Normally, output goes
  114. directly to the printer (PRN) on MS-DOS systems, and to a scratch file on
  115. Unix or VMS systems.  To send the output to a series of files foo1.xyz,
  116. foo2.xyz, ..., use the switch
  117.  
  118.     -sOutputFile=foo%d.xyz
  119.  
  120. The %d is a printf format specification; you can use other formats like
  121. %02d.  Each file will receive one page of output.  Alternatively, to send
  122. the output to a single file foo.xyz, with all the pages concatenated, use
  123. the switch
  124.  
  125.     -sOutputFile=foo.xyz
  126.  
  127. On Unix systems, you can send the output directly to a pipe.  For
  128. example, to pipe the output to the command `lpr' (which, on many Unix
  129. systems, is the command that spools output for a printer), use the
  130. switch
  131.  
  132. .nf
  133.     -sOutputFile=|lpr
  134. .fi
  135.  
  136. To find out what devices are available, type
  137.  
  138.     devicenames ==
  139.  
  140. after starting up Ghostscript.  Alternatively you can use the \-h or
  141. -? switch in the command line, as described above.
  142.  
  143. .SS "Device configuration"
  144.  
  145. Ghostscript is normally configured to expect U.S. letter paper,
  146. although there is a way to make A4 paper the default for certain
  147. printers at compilation time (see devs.mak for details).  To select a
  148. different paper size as the default, use the switch
  149.  
  150.     -sPAPERSIZE=a_known_paper_size
  151.  
  152. e.g.,
  153.  
  154.     -sPAPERSIZE=a4
  155.  
  156. or
  157.  
  158.     -sPAPERSIZE=legal
  159.  
  160. You can use any paper size listed in the table at the beginning of
  161. gs_statd.ps.  (Individual documents can also specify a paper size,
  162. which will take precedence over the one specified on the command
  163. line.)
  164.  
  165. Printing on a Hewlett-Packard DeskJet or LaserJet at full resolution
  166. (300 DPI) requires a printer with at least 1.5 Mb of memory.  150 DPI
  167. printing requires only .5 Mb.  You can select 150 DPI printing with
  168. the command line switch
  169.  
  170.     -r150
  171.  
  172. On MS-DOS systems using the Borland compiler, if Ghostscript gives
  173. you a 'limitcheck in setdevice' error, it may mean Ghostscript's
  174. standard buffer size wasn't large enough.  Likewise, if Ghostscript
  175. gives you a 'VMerror in setdevice' error, it means the buffer size
  176. was too large.  You can use the \-dBufferSpace= switch to set the
  177. buffer size to a different value, e.g.,
  178.  
  179.     -dBufferSpace=50000
  180.  
  181. The default value is 25000; the smallest value Ghostscript accepts is
  182. 10000; the largest valid value is 65000.
  183.  
  184. .SS "File searching"
  185.  
  186. When looking for the initialization files (gs_*.ps), the files related to
  187. fonts, or the file for the 'run' operator, Ghostscript first tries opening
  188. the file with the name as given (i.e., using the current working directory
  189. if none is specified).  If this fails, and the file name doesn't specify
  190. an explicit directory or drive (i.e., doesn't begin with '/' on Unix
  191. systems; doesn't contain a ':' or begin with a '/' or '\' on MS-DOS
  192. systems; doesn't contain a ':' or a square bracket on VMS systems),
  193. Ghostscript will try directories in the following order:
  194.  
  195. .TP
  196. -
  197. The directory/ies specified by the \-I switch(es) in the command
  198. line (see below), if any;
  199. .TP
  200. -
  201. The directory/ies specified by the GS_LIB environment variable,
  202. if any;
  203. .TP
  204. -
  205. The directories specified by the GS_LIB_DEFAULT macro, which is
  206. typically set to "/usr/lib/ghostscript:/usr/lib/ghostscript/fonts"
  207. at compilation time in the Ghostscript makefile.
  208.  
  209. .PP
  210. Each of these (GS_LIB_DEFAULT, GS_LIB, and \-I parameter) may be either
  211. a single directory, or a list of directories separated by a character
  212. appropriate for the operating system (':' on Unix systems, ';' on VMS
  213. and MS-DOS systems).
  214.  
  215. .SS "VMS-specific notes"
  216.  
  217. On VMS systems, the last character of each "directory" name indicates what
  218. sort of entity the "directory" references.  If the "directory" name ends
  219. with a colon, it is taken as referring to a logical device, e.g.:
  220.         $ DEFINE GHOSTSCRIPT_DEVICE DUA1:[GHOSTSCRIPT_14]
  221. .br
  222.         $ DEFINE GS_LIB GHOSTSCRIPT_DEVICE:
  223. .br
  224. If the "directory" name ends with a closing square bracket, it is taken as
  225. referring to a real directory, e.g.:
  226.         $ DEFINE GS_LIB DUA1:[GHOSTSCRIPT]
  227.  
  228. To run Ghostscript with switches, you must type a command like
  229.  
  230.     $ gs "-dNODISPLAY"
  231.  
  232. because the C run time library will convert the command
  233. parameters/arguments to lowercase unless you enclose them in double quotes
  234. which preserves the case.
  235.  
  236. If you are on an X Windows display (for which gs is built), you can do
  237.  
  238.     $ set display/create/node="domain-name"/transport=tcpip
  239.  
  240. For example,
  241.  
  242. .nf
  243.     $ set display/create/node="doof.city.com"/transport=tcpip
  244. .fi
  245.  
  246. and then run Ghostscript
  247.  
  248.     $ gs
  249.  
  250. If you write printer output to a file and then want to print the file
  251. later, use the "/PASSALL" qualifier to the PRINT command.
  252.  
  253.  
  254. .SS "MS-DOS notes"
  255.  
  256. If you are running Ghostscript on a MS-DOS machine with a display
  257. that is not EGA/VGA compatible, you must use the Borland compiler.
  258. You must build Ghostscript with the BGI driver as the default, and
  259. you will need the appropriate .BGI file from the Borland Turbo C
  260. library.  (Ghostscript includes the EGA/VGA driver in the
  261. executable.)
  262.  
  263. If you are using the BGI driver, two additional environment variables
  264. become relevant:
  265. .TP
  266. BGIPATH
  267. defines the directory where Ghostscript will look for
  268. the appropriate BGI driver.  If BGIPATH is not defined, Ghostscript will
  269. look in the directory defined as BGIDIR in the makefile.  In either case,
  270. if no driver is found in the designated directory, Ghostscript will look
  271. in the current directory.
  272. .TP
  273. BGIUSER
  274. a string of the form nn.dname, where nn is a hexadecimal
  275. number giving a display mode and dname is the name of a file containing a
  276. user-supplied BGI driver.  If BGIUSER is defined and the BGI device is
  277. selected, Ghostscript will supply nn as the display mode and will obtain
  278. the driver from the file named dname.
  279.  
  280. Some applications, such as Microsoft Word, require a prologue in front of
  281. the PostScript files they output.  In the case of Word, this is one of the
  282. *.ini files included with the Word distribution.  Other applications may
  283. require other prologues.  These may be specified on the Ghostscript
  284. command line, e.g.,
  285.     gs prologue.ini myfile.ps
  286.  
  287.  
  288. .SS "X Windows resources"
  289.  
  290. Ghostscript looks for the following resources under the program name
  291. ``Ghostscript'':
  292. .TP
  293. .B borderWidth
  294. the border width in pixels (default = 1)
  295. .TP
  296. .B borderColor
  297. the name of the border color (default = black)
  298. .TP
  299. .B geometry
  300. the window size and placement, WxH+X+Y (default = ???)
  301. .TP
  302. .B xResolution
  303. the number of x pixels per inch default is computed from WidthOfScreen
  304. and WidthMMOfScreen
  305. .TP
  306. .B yResolution
  307. the number of y pixels per inch default is computed from
  308. HeightOfScreen and HeightMMOfScreen
  309.  
  310. To set these resources, put them in a file (such as ~/.Xdefaults in X11R3
  311. or ~/.Xresources in X11R4 or X11R5) in the following form:
  312.  
  313. .nf
  314.     Ghostscript*geometry: 612x792-0+0
  315.     Ghostscript*xResolution: 72
  316.     Ghostscript*yResolution: 72
  317. .fi
  318.  
  319. Then load the defaults into the X server:
  320.  
  321. % xrdb \-merge ~/.Xresources
  322.  
  323. .SH OPTIONS
  324. The interpreter recognizes several switches described below, which may appear
  325. anywhere in the command line and apply to all files thereafter.
  326.  
  327. .SS "Normal switches"
  328.  
  329. .IP \fI@filename\fR  
  330.  
  331.  
  332. Causes Ghostscript to read filename and treat its
  333. contents the same as the command line.  (This is
  334. intended primarily for getting around DOS'
  335. 128-character limit on the length of a command line.)
  336. Switches or file names in the file may be separated by
  337. any amount of white space (space, tab, line break);
  338. there is no limit on the size of the file.
  339.  
  340. .IP "\fI\-\- filename arg1 ...\fR"
  341. Takes the next argument as a file name as usual, but takes
  342. all remaining arguments (even if they have the syntactic
  343. form of switches) and defines the name ARGUMENTS in
  344. userdict (not systemdict) as an array of those strings,
  345. *before* running the file.  When Ghostscript finishes
  346. executing the file, it exits back to the shell.
  347.  
  348. .IP \fI\-Dname=token\fR
  349. .IP \fI\-dname=token\fR
  350. Define a name in systemdict with the given definition.
  351. The token must be exactly one token (as defined by the
  352. `token' operator) and must not contain any whitespace.
  353.  
  354. .IP \fI\-Dname\fR
  355. .IP \fI\-dname\fR
  356. Define a name in systemdict with value=null.
  357.  
  358. .IP \fI\-Sname=string\fR
  359. .IP \fI\-sname=string\fR
  360. Define a name in systemdict with a given string as value.
  361. This is different from \fI\-d\fR.  For example,
  362. .RS
  363.        \-dname=35
  364. .RE
  365. is equivalent to the program fragment
  366. .RS
  367.        /name 35 def
  368. .RE
  369. whereas
  370. .RS
  371.        \-sname=35
  372. .RE
  373. is equivalent to
  374. .RS
  375.        /name (35) def
  376. .RE
  377. .IP \fI\-q\fR
  378. Quiet startup \-- suppress normal startup messages,
  379. and also do the equivalent of \fI-dQUIET\fR.
  380.  
  381. .IP "\fI\-gnumber1xnumber2\fR"
  382. Equivalent to \fI\-dDEVICEWIDTH=number1\fR and
  383. \fI\-dDEVICEHEIGHT=number2\fR.  This is for the benefit of
  384. devices (such as X11 windows and VESA displays) that require
  385. (or allow) width and height to be specified.
  386.  
  387. .IP "\fI\-rnumber1xnumber2\fR"
  388. Equivalent to \fI\-dDEVICEXRESOLUTION=number1\fR and
  389. \fI\-dDEVICEYRESOLUTION=number2\fR.  This is for the benefit of
  390. devices (such as printers) that support multiple
  391. X and Y resolutions.
  392.  
  393. .IP \fI\-Idirectories\fR
  394. Adds the designated list of directories at the head of the
  395. search path for library files.
  396.  
  397. .IP \fI\-\fR
  398.  
  399. This is not really a switch.  It indicates to Ghostscript
  400. that the standard input is coming from a file or a pipe.
  401. Ghostscript reads from stdin until reaching end-of-file,
  402. executing it like any other file, and then continues
  403. processing the command line.  At the end of the command
  404. line, Ghostscript exits rather than going into its
  405. interactive mode.
  406.  
  407. .LP
  408. Note that gs_init.ps makes systemdict read-only, so the values of names
  409. defined with \-D/d/S/s cannot be changed (although, of course, they can be
  410. superseded by definitions in userdict or other dictionaries.)
  411.  
  412. .SS "Special names"
  413. .IP \fI\-dDISKFONTS\fR
  414. causes individual character outlines to be loaded from the disk
  415. the first time they are encountered.  (Normally Ghostscript loads all the
  416. character outlines when it loads a font.)  This may allow loading more
  417. fonts into RAM, at the expense of slower rendering.
  418.  
  419. .IP \fI\-dNOBIND\fR
  420. disables the `bind' operator.  Only useful for debugging.
  421.  
  422. .IP \fI\-dNOCACHE\fR
  423. disables character caching.  Only useful for debugging.
  424.  
  425. .IP \fI\-dNODISPLAY\fR
  426. suppress the normal initialization of the output device.  This
  427. may be useful when debugging.
  428.  
  429. .IP \fI\-dNOPAUSE\fR
  430. disables the prompt and pause at the end of each page.  This may
  431. be desirable for applications where another program is 'driving'
  432. Ghostscript.
  433.  
  434. .IP \fI\-dSAFER\fR
  435. disables the deletefile and renamefile operators, and the
  436. ability to open files in any mode other than read-only.  This may be
  437. desirable for spoolers or other sensitive environments.
  438.  
  439. .IP \fI\-dWRITESYSTEMDICT\fR
  440. leaves systemdict writable.  This is necessary when running
  441. special utility programs such as font2c and pcharstr, which must bypass
  442. normal PostScript access protection.
  443.  
  444. .IP \fI\-sDEVICE=device\fR
  445. selects an alternate initial output device, as described above.
  446.  
  447. .IP \fI\-sOutputFile=filename\fR
  448. selects an alternate output file (or pipe) for the initial output
  449. device, as described above.
  450.  
  451. .SS "Debugging switches"
  452.  
  453. The \fI\-T\fR and \fI\-Z\fR switch only applies if the interpreter was built for a
  454. debugging configuration (this is usually not the case
  455. for Ghostscript executables installed for public use).
  456.  
  457. .IP \fI\-A\fR
  458. Turn on allocator debugging.
  459.  
  460. .IP \fI\-e\fR
  461. Turn on tracing of error returns from operators.
  462.  
  463. .IP \fI\-E\fR
  464. Abort when any operator returns with an error.
  465.  
  466. .IP \fI\-Mn\fR
  467. Force the interpreter's allocator to acquire additional
  468. memory in units of nK, rather than the default (currently
  469. 20K on MS-DOS systems, 50K on Unix).  n is a positive
  470. decimal integer (not exceeding 63 on MS-DOS systems).
  471.  
  472. .IP \fI\-Zxxx\fR
  473. Turn on debugging printout.
  474. Each of the xxx characters selects an option:
  475. if the string is empty, all options are selected.
  476. Case is significant.
  477. .RS
  478. .nf
  479.         1 = type 1 font interpreter (type1addpath)
  480.         2 = curve subdivider/rasterizer
  481.         a = allocator (large blocks only)
  482.         A = allocator (all calls)
  483.         b = bitmap image processor
  484.         B = bitmap images, detail
  485.         c = color/halftone mapper
  486.         d = dictionary put/undef
  487.         f = fill algorithm (summary)
  488.         F = fill algorithm (detail)
  489.         g = gsave/grestore[all]
  490.         h = halftone renderer
  491.         i = interpreter, just names
  492.         I = interpreter, everything
  493.         k = character cache
  494.         K = character cache, every access
  495.         l = command lists, bands
  496.         L = command lists, everything
  497.         m = makefont and font cache
  498.         n = name lookup (new names only)
  499.         o = outliner (stroke)
  500.         p = path tracer
  501.         q = rectangle fill
  502.         r = arc renderer
  503.         s = scanner
  504.         t = tiling algorithm
  505.         u = undo saver (for save/restore)
  506.         U = undo saver, more detail
  507.         v = rectangle fill
  508.         V = device-level output
  509.         w = compression encoder/decoder
  510.         x = transformations
  511.         z = trapezoid fill
  512. .fi
  513. .RE
  514.  
  515. .SH "EXAMPLES"
  516. .nf
  517.      spam% gs
  518.       Initializing... done.
  519.       Ghostscript 2.5.2 (9/19/92)
  520.         Copyright (C) 1990, 1992 Aladdin Enterprises, Menlo Park, CA.
  521.         All rights reserved.
  522.       Distributed by Free Software Foundation, Inc.
  523.       Ghostscript comes with NO WARRANTY: see the file LICENSE for details.
  524.       GS> 100 100 moveto 200 400 lineto stroke
  525.       GS> erasepage
  526.       GS> (/usr/um/lib/ghostscript/tiger.ps) run
  527.       >>showpage, press <return> to continue<<
  528.       GS> quit
  529.  
  530. .fi
  531. .SH "Unix  NOTES"
  532.  
  533. At most installations, the only available display device is x11, so
  534. you must be running X11 windows to use ghostscript unless you use the
  535. command line option \fI\-dNODISPLAY\fR.  There is also a script
  536. called 'gsnd' which is just 'gs \-DNODISPLAY \-q $*'.
  537.  
  538. At most installations, Ghostscript was not built for a debugging
  539. configuration therefore the command line option \fI\-Zxxx\fR is not
  540. available.  This speeds up the interpreter.
  541.  
  542. Ghostscript works with color postscript files, postscript files created by
  543. Tom Rokicki's dvips, M-PLOT, Mathematica, Tell-a-Graf, etc.  You can, for example,
  544. preview multiple pages of a postscript file created by Latex/dvips/psfig
  545. and you will be able to see any included postscript figure.  If the postscript
  546. file adheres to Adobe's Document Structuring Convention, like the ones
  547. generated by Latex/dvips, then you are advised to use
  548. .B ghostview
  549. to preview your postscript document for it provides a far more friendly and
  550. graphical user interface.
  551.  
  552. Ghostscript also has the ability to convert a postscript file to a PPM file.
  553. Once you have a file in PPM format you can display or manipulate it in many
  554. ways.  You can, for example, use 'xv' or other tools to convert the PPM file
  555. to a variety of formats, like GIF, TIFF, PICT, RLE, XPM, GPR (only available
  556. on the apollos, through the program /progs/bit2bit/bin/ppm2gpr) etc.
  557.  
  558. .nf
  559. Example:
  560.       spam% gs
  561.       Initializing... done.
  562.       Ghostscript 2.5.2 (9/19/92)
  563.         Copyright (C) 1990, 1992 Aladdin Enterprises, Menlo Park, CA.
  564.         All rights reserved.
  565.       Distributed by Free Software Foundation, Inc.
  566.       Ghostscript comes with NO WARRANTY: see the file LICENSE for details.
  567.       GS> (pstoppm.ps) run
  568.       Usage: (file) ppmNrun
  569.          converts file.ps to file.ppm (single page),
  570.            or file.1ppm, file.2ppm, ... (multi page).
  571.          N is # of bits per pixel (1, 8, or 24).
  572.       Examples: (golfer) ppm1run   ..or..   (escher) ppm8run
  573.       Optional commands you can give first:
  574.          horiz_DPI vert_DPI ppmsetdensity
  575.          (dirname/) ppmsetprefix
  576.          page_num ppmsetfirstpagenumber
  577.       GS> 100 120 ppmsetdensity
  578.       GS> (/tmp/) ppmsetprefix
  579.       GS> (tiger) ppm24run
  580.       Writing /tmp/tiger.ppm
  581.       GS> quit
  582.  
  583.       spam% ppmtogif < /tmp/tiger.ppm > /tmp/tiger.gif
  584.       ppmtogif: computing colormap...
  585.       ppmtogif: 39 colors found
  586.  
  587.       spam% ls \-l tiger.ps /tmp/tiger.ppm /tmp/tiger.gif       
  588.       \-rw-r--r--   1 oliveria    41796 Apr 21 18:44 /tmp/tiger.gif
  589.       \-rw-r--r--   1 oliveria  3366054 Apr 21 18:36 /tmp/tiger.ppm
  590.       \-rw-r--r--   1 oliveria    78519 Apr 21 17:39 tiger.ps
  591. .fi
  592.  
  593. Notice that ppm24run creates huge files.
  594.  
  595. IslandDraw version 3.0 or greater is also able
  596. to read (select 'Convert...'  under the 'File' menu) single\-page postscript
  597. files.  It can also save the postscript file in a variety of formats.
  598.  
  599. .SH SYSTEM FILES
  600. .TP 15
  601. .B gs_init.ps
  602. Ghostscript reads this automatically when it starts up.  It
  603. contains definitions of many standard procedures and initialization for a
  604. wide variety of things.
  605. .TP 15
  606. .B gs_fonts.ps
  607. Font initialization.  gs_init.ps reads this in.  It initializes Ghostscript's font
  608. machinery and provides some utility procedures that work with fonts.
  609. .TP 15
  610. .B gs_statd.ps
  611. gs_init.ps reads this in.  It creates a dummy statusdict and
  612. some other environmental odds and ends for the benefit of P*stScr*pt files
  613. that really want to be printed on a LaserWriter.
  614. .TP 15
  615. .B gs_2asc.ps
  616. This utility file helps extract the ASCII text from PostScript source files.
  617. It redefines many operators.  For more information, see the comments in
  618. the file.
  619. .TP 15
  620. .B gs_dps1.ps
  621. gs_init.ps reads this in if the dps feature is included in
  622. the configuration.  It provides support for various Display PostScript and
  623. Level 2 features.
  624. .TP 15
  625. .B sym__enc.ps
  626. the Symbol encoding, loaded only if referenced.
  627.  
  628. .SH ART
  629. .TP 15
  630. chess.ps
  631. a black-and-white chessboard.
  632. .TP 15
  633. .B golfer.ps
  634. a gray-scale picture of a stylishly dressed woman swinging a golf club.
  635. .TP 15
  636. .B escher.ps
  637. a colored version of a hexagonally symmetric Escher drawing of
  638. interlocking butterflies.  Can be printed on monochrome devices, with
  639. somewhat less dramatic results.
  640. .TP 15
  641. .B cheq.ps
  642. a chessboard "font" used by chess.ps (obtained from the Adobe file server).
  643. .TP 15
  644. .B snowflak.ps
  645. a rectangular grid of intricate colored snowflakes.  (Renders very slowly.)
  646. .TP 15
  647. .B colorcir.ps
  648. a set of nested ellipses made up of colored bars.
  649. .TP 15
  650. .B tiger.ps
  651. a dramatic colored picture of a tiger's head.
  652.  
  653. .SH UTILITIES
  654. .TP 15
  655. .B bdftops.ps
  656. a utility for converting BDF fonts to outline form.
  657. .TP 15
  658. .B decrypt.ps
  659. a utility for decrypting the eexec section of a font.
  660. .TP 15
  661. .B gslp.ps
  662. a utility for doing "line printing" of plain text files.
  663. .TP 15
  664. .B impath.ps
  665. a utility for reconstructing outlines from bitmap images,
  666. used by bdftops.
  667. .TP 15
  668. .B landscap.ps
  669. a file that you can put in front of your own files to get
  670. them rendered in landscape mode.
  671. .TP 15
  672. .B pstoppm.ps
  673. a utility for rendering PostScript files onto PPM (bitmap) files.
  674. .TP 15
  675. .B ps2image.ps
  676. a utility for converting an arbitrary PostScript file into a
  677. PostScript file consisting of just bitmaps, one per page.
  678. .TP 15
  679. .B wrfont.ps
  680. a utility for writing out an unprotected Type 1 font, such as
  681. the standard Ghostscript fonts.
  682.  
  683. .SH ODDS and ENDS
  684. .TP 15
  685. .B empty.ps
  686. an empty file.
  687. .TP 15
  688. .B lines.ps
  689. a test program for line joins and caps.
  690. .TP 15
  691. .B pcharstr.ps
  692. a program to print out the CharStrings and Subrs in a Type 1
  693. font.
  694. .TP 15
  695. .B ppath.ps
  696. a couple of utilities for printing out the current path, for debugging.
  697. .TP 15
  698. .B prfont.ps
  699. a program to print a font catalog.
  700. .TP 15
  701. .B quit.ps
  702. a file containing just the word "quit".
  703. .TP 15
  704. .B traceop.ps
  705. a memory usage monitor for debugging.
  706. .TP 15
  707. .B type1ops.ps
  708. the Type 1 font format opcodes.
  709. .TP 15
  710. .B unprot.ps
  711. a program to disable access checking.
  712.  
  713. .SH FILES
  714. .TP 15
  715. .B Fontmap
  716. A catalog of fonts known to
  717. .B gs.
  718. Lists the GhostScript name, corresponding font file name, font encoding
  719. and font identification number for each font that
  720. .B gs
  721. knows.
  722. .TP 15
  723. .B /usr/um/lib/ghostscript
  724. Initialization files, utilities, sample postscript files
  725. .TP 15
  726. .B /usr/um/lib/ghostscript/fonts
  727. Ghostscript and Hershey fonts (*.gsf files)
  728.  
  729. .SH KNOWN PROBLEMS
  730. The interactive interpreter requires that every statement fit on a line,
  731. i.e., you can't have an unpaired ( or {.
  732.  
  733. On a MS\-DOS system, interrupting Ghostscript by typing ^C doesn't restore
  734. the display mode.
  735.  
  736. The Ghostscript language does not include the following operators of the
  737. PostScript language:
  738. .nf
  739.     resetfile
  740.     banddevice, renderbands
  741. .fi
  742.  
  743. The following are not implemented completely:
  744. .nf
  745.     %statementedit (file name): interpreted as equivalent to
  746. %lineedit.
  747. .fi
  748.  
  749. Most of the new color operators, particularly those that support the CMYK
  750. color model, are implemented as Ghostscript language procedures, and they
  751. essentially emulate CMYK using RGB.
  752.  
  753. The following operators that expect arrays won't accept packed arrays:
  754. .nf
  755.     definefont (Subrs (type 1 fonts))
  756.     setdash (dash pattern)
  757.     setcachedevice (bounding box)
  758.     makeimagedevice (palette)
  759. .fi
  760.  
  761. The file operator only recognizes modes r and w, not the newer modes r+,
  762. w+, a, and a+.
  763.  
  764. Floating point exceptions terminate Ghostscript, rather than producing a
  765. rangecheck error.
  766.  
  767. Some access checks aren't implemented.
  768.  
  769. copypage does nothing in the MS\-DOS implementation, and merely
  770. synchronizes the X connection in the Unix implementation.  showpage is a
  771. procedure that does a copypage and then beeps the bell and waits for the
  772. user to hit a key.  (copypage does do the right thing for printers.)
  773.  
  774. strokepath produces incorrect output for dashed lines.
  775.  
  776. The implementation only looks at the PaintType of the font when doing
  777. show, not when doing charpath.  Because of this, stroked fonts don't work
  778. correctly with charpath.
  779.  
  780. arcto gives an error for negative radii.
  781.  
  782. Changing the contents of the Encoding array or the Metrics dictionary of a
  783. font dynamically doesn't produce the expected result (may have no effect)
  784. if character caching is enabled.
  785.  
  786. Halftone patterns "flip over" at the 50% coverage point, producing
  787. anomalous visual effects on some color devices.
  788.  
  789. We have not been able to test 2\-, 4\-, and 16\-bit memory devices as
  790. thoroughly as 1\-, 8\-, 24\-, and 32\-bit devices; please report any
  791. problems.
  792.  
  793. Opening more than one window device at the same time doesn't work.
  794. This is the case for both X Windows and Microsoft Windows.
  795.  
  796. restore doesn't properly undo currentgstate.
  797.  
  798. copy doesn't handle gstates.
  799.  
  800. .SH BUGS
  801. See the netnews group ``gnu.ghostscript.bug'' for more information.
  802.  
  803. .SH "SEE ALSO"
  804. .br
  805. The PostScript Language Reference Manual, Adobe Systems Incorporated,
  806. Second Edition, Addison\-Wesley Publishing Company, ISBN 0\-201\-18127\-4, 1990
  807. .br
  808. X(1), ghostview(1), lpr(1), dvips(1), ppm(5), xv(1)
  809. .br
  810.